Summary

Adds a reference analysis document for MinishLab/semble — the upstream Python library that csp ports — mapped to the Rust rewrite (crates/csp + crates/csp-cli) per ADR-0003.

Analyzed at upstream semble 136b6f7 and Rust port 2f2baa2.

Changes

• .please/docs/references/semble.md — module-by-module analysis: pipeline overview, semble→Rust module map, per-module deep dives (algorithms + Rust idioms), load-bearing constants table (semble vs Rust), divergences/drift section.
• .please/docs/references/index.md — index for reference analyses, structured to scale as more upstream libraries are added.
• .please/INDEX.md — registered the docs/references/ directory with a link to the new index.
• CLAUDE.md — added a "Reference Analyses" entry under the Project Knowledge section.

Key findings surfaced

• TD-002: search.rs ranking still uses inline stubs (apply_query_boost identity, rerank_top_k saturation-only); the full ranking::{boosting,penalties} modules are ported but unwired — mirroring the TS source. Search-ranking parity is fixture-level only.
• Tree-sitter grammar coverage: Rust port uses a curated ~14-grammar static set vs upstream's tree_sitter_language_pack (≈all languages); unsupported languages fall back to line chunking.
• Upstream drift: semble changed the desired chunk length to 750, but csp (TS + Rust) still uses 1500.

Notes

• Documentation only — no source or test changes.
• No linked issue.

Summary by cubic

Adds a semble→Rust reference analysis under .please/docs/references with an index and links, documenting the port, algorithms, constants, divergences, and sync baselines. Highlights key gaps: ranking is stubbed in search.rs, Rust uses a curated grammar set, and upstream chunk length is 750 while the port remains 1500.

• New Features
  • .please/docs/references/semble.md — module map, pipeline, algorithms, constants, and drift.
  • .please/docs/references/index.md — references index with a documents table, sync baselines, and how-to add analyses.
  • .please/INDEX.md — updates the references entry to point to the new index.
  • CLAUDE.md — adds a “Reference Analyses” section.

^{Written for commit 0833a21. Summary will update on new commits.}

Summary by CodeRabbit

• Documentation
  • Added a new “Reference Analyses” section with guidance that these materials are reference-only (not contracts)
  • Created reference documentation for the semble library, including end-to-end mapping, pipeline details, and module-by-module parity notes
  • Documented how to add new reference analysis documents (pin upstream commit, module mapping, and registration)
  • Updated the documentation index and adjusted a “Directory Map” entry’s descriptive text